Setting environment extensions

You can set extension values for one or more processes deployed to basic runtimes attached to the selected environment on the Environment Extensions dialog.

note

You must have the Runtime Management privilege (as well as Environment Management) to set extensions on the Extensions dialog. If you have the Runtime Management Read Access privilege, you can only view existing extensions and open the Audit Logs dialog.

Open the dialog by clicking Environment Extensions in the Environment Properties tab. You can set values for the following types of extensions:

• Connection settings
• Operation settings
• Trading Partner settings
• Dynamic process properties
• Process properties
• Cross reference tables
• PGP certificates
• Data maps

After you update extensions, all listeners restart.

caution

When a process is undeployed and you update or save extensions, those changes related to the undeployed process are lost.

1. Select Manage > Runtime Management.

2. Select an environment from the list on the left.

3. From the Environment Management screen, click Environment Extensions.

4. Do one of the following:

   a. To filter the controls below to show only extensions defined for a particular process:

   • Click Choose the desired component adjacent to Process Filter.
   • Select the process in the component chooser.

   b. To set extension values for a particular process in an installed, attached multi-install integration pack:

   • In the Process Type list, select Multi Installation Integration Packs.

     note

     This list option displays only if your multi-installation integration packs are installed on your account.

   • Click Choose the desired component adjacent to Process.

   • Select the process in the component chooser.

Connection settings

1. Select the Connection Settings tab.

2. In the Connection list, select a Connection component for which settings extensions are defined.

3. For each extension for which you want to set a value, clear the Use Default? checkbox and enter a value. If Use Default? is checked, the value configured in the underlying Connection component is used at run time.

4. Repeat steps 2-3 for each additional Connection component for which settings extensions are defined.

5. When you are finished setting extension values, click OK.

Operation settings

1. Select the Operation Settings tab.

2. Select the Listen Operation from the drop-down list.

3. For each extension for which you want to set a value, clear the Use Default? checkbox and enter a value. If Use Default? is checked, the value configured in the underlying Connection component is used at run time.

4. Repeat steps 2-3 for each additional Connection component for which settings extensions are defined.

5. When you are finished setting extension values, click OK.

Trading Partner settings

1. Select the Partner Settings tab.

2. Do one of the following:

   a. To set extension values for a Trading Partner for which settings extensions are defined, in the Component Type list, select Trading Partner, and then in the Component Name list, select the Trading Partner.

   b. To set extension values for a Communication Channel for which settings extensions are defined, in the Component Type list, select Communication Channel, and then in the Component Name list, select the Communication Channel.

3. In the Extension Set list, select an extension set (settings category).

4. For each extension for which you want to set a value, clear the Use Default? checkbox and enter a value. If Use Default? is checked, the value configured in the underlying Connection component is used at run time.

5. For each additional extension set applicable to the selected Trading Partner or Communication Channel, repeat steps 3-4.

6. For each additional Trading Partner or Communication Channel for which settings extensions are defined, repeat steps 2-4.

7. When you are finished setting extension values, click OK.

Dynamic process properties

1. Select the Dynamic Process Properties tab.

2. Enter a value for each property.

3. When you are finished setting extension values, click OK.

Process properties

1. Select the Process Properties tab.

2. In the Process Property list, select a process property component for which property extensions are defined.

3. For each extension for which you want to set a value, clear the Use Default? check box and enter a value. If Use Default? is on, the value configured in the underlying process property component is used at run time.

4. For each additional process property component for which property extensions are defined, repeat steps 2-3.

5. When you are finished setting extension values, click OK.

Cross reference tables

1. Select the Cross Reference tab.

2. In the Cross Reference list, select a Cross Reference Table component for which an extension is defined.

3. Select the Override check box. If Override is cleared, the values in the underlying Cross-Reference Table component will be used at run time.

4. Modify the Cross Reference Table values.

   The controls for modifying values are identical to those used in the Build page to create and edit a cross reference table component. You can import a cross-reference table or directly edit values in the table grid. However, you cannot insert or delete columns or modify column headings.

5. For each additional Cross Reference Table for which an extension is defined, repeat steps 2-4.

6. When you are finished setting extension values, click OK.

PGP certificates

1. Select the PGP tab.

2. In the PGP list, select a PGP Certificate component for which an extension is defined.

3. Clear the Use Default? check box. If Use Default? is on, the certificate configured in the underlying PGP Certificate component will be used at run time.

4. In the component chooser, select the PGP Certificate to use at run time.

5. For each additional PGP Certificate for which an extension is defined, repeat steps 2-4.

6. When you are finished setting extension values, click OK.

Data maps

1. Select the Data Map tab.

   In the Data Maps list, select a data map for which an extension is defined. The data maps are identified in the list by the source and destination object definition names specified on the Object Definitions tab in the process Extensions dialog. Depending on the connector types used to originally build the profiles, first select the basic runtimes to use to browse for the profiles.

   The source and destination profiles are browsed and loaded. This may take a few moments depending on the connector types used to originally build the profiles.

   tip

   If connection settings were extended but browsing for the source or destination profile fails, an error message will appear for that profile. Do the following:

   1. Click the "X" adjacent to the error message.

   2. Click Edit Credentials.

   3. In the Connection Settings dialog, type the correct extension values.

   4. Click OK.

      Another attempt will be made to browse and load the profile.

2. Set data map extension values — flat file profile-based object field additions:

   Perform the following sub-steps as needed separately for the source and destination object definitions:

   a. Click Edit flat file extensions.

   The Flat File Extensions dialog opens.

   b. Add a field: Click the plus icon to add an element.

   The new field is automatically selected in the field list.

   c. In the Data Name field, replace “New Element” with the name of the new field.

   d. Use the controls below the Data Name field to set field options.

   These controls are identical to those used in the Build page to create and edit a flat file profile component.

   e. For each additional field you want to add, repeat steps B–D.

   f. Click OK.

3. Set data map extension values — field-to-field mappings:

   a. After you selected a data map from the list in step 1, the source and destination profiles and their mappings appear.

   b. (Optional) If you want to add standard or user-defined functions to your extended map, click the plus icon. Configure the extensible standard or user-defined function.

   note

   If you use extensions with integration packs, the Connector Call function is available but cannot be used. This is because no connection or operation components are available in the Connector Call dialog.

   c. In the source column on the left, select the source element to map.

   d. Drag a line to an element in the destination profile on the right.

   e. (Optional) If you want to use a function, drag a line to the function, and then drag another line to the destination element.

   f. For each additional mapping you want to add, repeat steps A–E.

4. For each additional data map for which an extension is defined, repeat steps 1-3.

5. When you are finished setting extension values, click OK.